Chromium Android开发的Eclipse配置

单次的Eclipse配置

这一节包含第一次启动Eclipse时需要的设置步骤。你应该只需浏览这个部分一次,即使你切换了workspaces。

  • 启动Eclipse。它可以通过如下的两种方式启动:

    • 在Ubuntu的主菜单,选择 Applications > Programming > Eclipse 4.5
    • 在命令行中,输入 eclipse45
  • 选择你硬盘上的某个位置作为 workspace。

  • 安装CDT - C/C++ Development Tools

  • 内存

    • 关闭 Eclipse
    • 将如下的几行添加到 ~/.eclipse/init.sh
      1
      2
      ECLIPSE_MEM_START=1024m
      ECLIPSE_MEM_MAX=8192m

通用 Workspace 配置

有一些设置应用于你的 workspace 的所有工程。下面的所有设置都在 Window > Preferences里。

  • Android格式化 (formatting)

    • 下载 android-formatting.xml
    • 在左边的配置树中选择 Java > Code Style > Formatter
    • 点击 Import…
    • 选中 android-formatting.xml 文件
    • 确认 Active profile 已经被设置为了Android
  • Java import 顺序

    • 下载 android.importorder
    • 在左边的配置树中选择 Java > Code Style > Organize Imports
    • 点击 Import…
    • 选中 android.importorder 文件
  • 禁用自动刷新 (automatic refresh)。否则,Eclipse将时常地去刷新你的工程(那可能会比较慢)。

    • 在左边的配置树中选择 General > Workspace
    • 如果选中了的话就反选 Refresh using native hooks or polling
    • 在左边的配置树中选择 General > Startup and Shutdown
    • 如果选中了的话就反选 Refresh workspace on startup
  • 禁用 build before launching

    • 选择 Run/Debug > Launching
    • 反选 Build (if required) before launching
  • .gyp 和 .gypi文件类型配置

    • 选择 General > Editors > File Associations
    • 添加 .gyp.gypi 文件类型,并将它们与 Python Editor关联。
    • 通过 Ctrl+Shift+P 和自动匹配 bracket highlight 来享受快乐的生活吧
  • Tab ordering

    • If you prefer ordering your tabs by most recently used, go to General > Appearance and check Show most recently used tabs
  • 自动完成

    • 选择 Java > Editor > Content Assist
    • 选中 Enable auto activation
    • 修改 Auto activation triggers for Java: 为 ._abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ
  • 单行长度

    • 如果你想要修改单行长度指示器,则选择 General > Editors > Text Editors
    • 选中 Show print margin 并将 Print margin column: 修改为 100。

工程配置

创建工程

  • 在主菜单选择 File > New > Project…
  • 在工程树中选择 C/C++ > C++ 并点击 Next。
    • 注意:不是 “Makefile Project with Existing Code”,即使那听起来不错。
  • 关于工程名 (Project name),使用一个对你来说有意义的名字。比如 “chrome-android”
  • 反选 Use default location。点击 Browse… 并选择你的 Chromium gclient目录的src 目录。
  • 关于工程类型(Project type),使用 Makefile project > Empty Project。
  • 关于 Toolchains 则使用 – Other Toolchain –
  • 点击 Next
  • 禁用 默认 CDT builder
    • 点击 Advanced Settings…
    • 在左边的配置树中选择 Builders
    • 反选 CDT Builder
    • 如果出现了 这是一个 ‘advanced feature’ 的警告对话框就点击 OK。
    • 点击 OK 关闭 工程属性对话框 (project properties dialog) 并返回工程创建向导 ( project creation wizard )
    • 点击 Finish 创建工程

配置工程

  • 在工程上右键点击鼠标并选择 Properties

  • 排除 Resources (可选的). 这个可以加快 Eclipse 一点,并可能使indexer更开心。

    • 选择 Resources > Resource Filters
    • 点击 Add…
    • 选择 Exclude all,选择文件夹,并选中 All children (recursive)
    • 键入 .git 作为名字
    • 点击 OK
    • 点击 Apply 提交修改
  • C/C++ Indexer (deprecated, seems to be done by default)

    • 在左边的配置树中选择 C/C++ General > Indexer
    • 点击 Restore Defaults
    • 选中 Enable project specific settings
    • 反选 Index source files not included in the build
    • 反选 Allow heuristic resolution of includes
    • 点击 Apply 提交修改
  • C/C++ Paths and Symbols. 这将帮助 Eclipse
    为 Chrome构建 symbol。

    • 如果使用gyp构建系统的话,则在命令行中运行GYP_GENERATORS=eclipse build/gyp_chromium;如果使用 gn 构建系统的话,则在命令行中运行 gn gen out/Default/ --ide=eclipse,然后执行命令 tools/android/eclipse/generate_cdt_clang_settings.py out/Default/eclipse-cdt-settings.xml
    • 这将生成 <project root>/out/Release/eclipse-cdt-settings.xml<project root>/out/Default/eclipse-cdt-settings.xml 文件,后面会用到。
    • 在左边的配置树中选择 C/C++ General > Paths and Symbols
    • 点击 Restore Defaults 清楚所有旧设置。
    • 点击 Import Settings… 将显示导入对话框。T
    • 点击 Browse… 将显示 文件浏览器
    • 选择 /out/Default/eclipse-cdt-settings.xml。
    • 点击 Finish 按钮。整个首选项对话框应该消失。
    • 在工程上右键点击鼠标,并选择Index > Rebuild
  • Java

    • 创建一个指向 /tools/android/eclipse/.classpath 的链接 /.classpath:
      1
      ln -s tools/android/eclipse/.classpath .classpath
  • 以如下方式编辑 /.project ,使工程成为一个Java工程:

    • 中添加如下几行:

      1
      2
      3
      4
      <buildCommand>
      <name>org.eclipse.jdt.core.javabuilder</name>
      <arguments></arguments>
      </buildCommand>
    • 中添加如下几行:

      1
      <nature>org.eclipse.jdt.core.javanature</nature>

参考文档:

Eclipse Configuration for Android

坚持原创技术分享,您的支持将鼓励我继续创作!